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Preface 


Many years ago, I was a radio telegraph operator with the US Air Force, 
mainly using International Morse code. Therefore, Morse code is a topic 
that I know something about. This is the first module in a book about Morse 
code and computer programs. 


This module was created using Apache OpenOffice Writer and was then 
translated to CNXML suitable for uploading and publishing on OpenStax. 


General background information 


A few weeks ago, I was asked to assist a grandchild who was working on a 
science project involving Morse code. I went online and searched for a 
program that could translate text into Morse code. I found a few good 
online websites, such as the Morse Code Translator. However, I was unable 
to find a good stand-alone program that could be used to translate text into 
Morse code independently of an Internet connection. I decided to write my 
own program. This book is the culmination of that effort. 


Miscellaneous 


This section contains a variety of miscellaneous information. 


Note: 
Housekeeping material 


e Module name: Morse1000 Preface 
e File: Morese1000.odt 
e Published: 04/28/16 


Note: 

Disclaimers: 

Although the OpenStax site makes it possible for you to download a PDF 
file for this module at no charge, and also makes it possible for you to 
purchase a pre-printed version of the PDF file, you should be aware that 
some of the HTML elements in this module may not translate well into 
PDF. 

I also want you to know that, I receive no financial compensation from the 
OpenStax website even if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from OpenStax, 
converted them to Kindle books, and placed them for sale on Amazon.com 
showing me as the author. I neither receive compensation for those sales 
nor do I know who does receive compensation. If you purchase such a 
book, please be aware that it is a copy of a module that is freely available 
on OpenStax and that it was made and published without my prior 
knowledge. 


-end- 
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Preface 


As I mentioned in an earlier module , a few weeks ago, I was asked to assist 
a grandchild who was working on a science project involving Morse code. I 
went online and searched for a stand-alone program that could translate text 
into Morse code. I found a few good online websites, such as the Morse 
Code Translator. However, I was unable to find a good stand-alone 
program that could be used to translate text into Morse code independently 
of an Internet connection. Therefore, I decided to write my own program. 
This module describes my first effort in that regard. 


This document was created using Apache OpenOffice Writer and then 
translated to CNXML suitable for uploading and publishing on OpenStax. 


Viewing tip 


I recommend that you open another copy of this module in a separate 
browser window and use the following links to easily find and view the 
Figures and Listings while you are reading about them. 


Figures 


e Figure 1. The output for HELLO WORLD. 


Listings 


¢ Listing 1. Beginning of the program. 

e Listing 2. Create a hashtable. 

e Listing 3. Begin processing the input data stream. 

e Listing 4. Get the Morse code for the character. 

e Listing 5. Display the character and the code. 

e Listing 6. Convert the Morse code to musical notes. 

e Listing 7. Insert silence between characters. 

e Listing 8. Writing the output file. 

e Listing 9. The program named MorseCodeGenerator01 


General background information 


As I also mentioned in the earlier module , I was once a radio operator with 
the U.S. Air Force, mainly using International Morse code. Therefore, 
Morse code is a topic that I know something about. 


Historical perspective 


Before getting into the programming details, however, I will provide some 
historical perspectives on Morse code. According to Wikipedia , "Morse 
code is a method of transmitting text information as a series of on-off tones, 
lights, or clicks that can be directly understood by a skilled listener or 
observer without special equipment." 


The "code" was invented by Samuel F. B. Morse around 1836 to describe 
the characters used in the U.S. telegraph system at the time. The code was 
later expanded by others to include additional characters. 


Most people think of the code in terms of dots and dashes. The Wikipedia 
reference given above contains an image showing the dots and dashes 
representing what has come to be known as International Morse Code. 
(Note that there are no lower-case letters in the code.) Although an 
expanded version of the code includes other characters such as punctuation 


marks, the program that I will present in this module will deal only with 
letters, numbers, and the space character. 


Sounds 


Because of the equipment that was used, the early telegraphers thought of 
the code in terms of clicks where a dot was represented by two closely 
spaced clicks and a dash was represented by two clicks spread further apart 
in time. You may have seen this in movies about the late 1800's. 


A sailor in the U.S. Navy whose job was and possibly still is to use flashing 
lights for line-of-sight communication between ships at sea may think of the 
code in terms of the lengths in time of the flashes. A short flash represents a 
dot and a longer flash represents a dash. You have probably seen that 
portrayed in movies about the navy. 


A radio operator like myself thinks of the code in terms of truncated tones. 
A dot sounds something like dit and a dash sounds something like dah. 
Click here to download and play an audio file containing the Morse code 
for the text HELLO WORLD. (Did it sound like dits and dahs to you?) 


In the communication facility where I worked, we always used a typewriter 
to type out the message that we were hearing through the headphones. An 
experienced operator didn't even think of dits and dahs. Instead, the sounds 
seemed to go straight from the ears to the fingers pressing the typewriter 
keys without any thought being given to what was being heard. 


Using previously published code 


Sometime back, I published a module titled Jbs2060-A Player Piano 
Simulator . 


Note: 


If you haven't read that module, I recommend that you read it for context 
before trying to understand the programming code that I will present later 
in this module. Note however that the programming code in this module is 
much less complex than the programming code in the earlier module. You 
won't need to understand the code in that module in order to understand the 
code in this module. 


In brief, the program named MusicComposer 09 that I described in that 
module allows you to define a text file that represents a melody to be 
played by the player piano program. (For brevity, I will refer to the player 
piano program as the PPP in this module.) When the program named 
MusicComposer09 reads the text file, it plays the melody through the 
speakers connected to the computer. 


The approach that I took for the program named M orseCodeGenerator01 
in this module was straightforward. The program defines a short melody 
representing the Morse code sounds for each of the numbers from 0 through 
9 and each of the letters from A through Z. Then it reads a text file 
containing a message. For each character in the message, the program sends 
the appropriate melody to an output file concatenating it onto the melodies 
for each of the previous characters. The result is an output file which, when 
played by MusicComposer09 produces the Morse code sounds 
representing the stream of characters in the message. Optionally, those 
sounds are also recorded in an audio file for playback later. 


Note that no modifications were made to the program named 
MusicComposer 09 . As far as that program is concerned, the file produced 
by M orseCodeGenerator01 is just another melody similar to 
Greensleeves and Mary Had a Little Lamb , although perhaps not as 
familiar. 


How does it sound? 


To be honest, when I started down this path, I had no idea how the sound of 
the Morse code melodies produced by this program would compare with the 
sounds of Morse code created using more conventional techniques such as a 
key, an oscillator, a radio receiver, etc. However, I am very pleased with the 
results. The Morse code created using this approach is much cleaner than 
typical Morse code generated by a human operator using a hand key such as 
the one shown and identified as a straight key in the article titled Telegraph 
key_. By the way, this is the same key that I used in the U.S. Air Force. 


Discussion and sample code 


A complete listing of the program is provided in Listing 9 near the end of 
the lesson. I will break the program down and explain it in fragments. 


Beginning of the program 


The program begins in Listing 1. 


Note: 
Listing 1. Beginning of the program. 


import java.io.FileReader,; 
import java.io.BufferedReader ; 
import java.util.*; 


public class MorseCodeGeneratoroi{ 
public static void main(String[] args){ 
run(args[0]); 
}//end main 


static void run(String inputFile) { 
//Read the input data 


String data = readInputFile(inputFile); 


The code in Listing 1, which shows the main method and the beginning of 
the run method is routine and should not require an explanation. 


Create a hashtable 


The run method is continued in Listing 2. The code in Listing 2 is much 
more interesting than Listing 1. Listing 2 creates a Hashtable object and 
populates its keys with a space character, the letters of the alphabet, the 
numbers from 1 through 0, and "error". 


Note: 
Listing 2. Create a hashtable. 


//Create a hash table containing the codes 
// for letters, numbers, the space character, 
// and an error character. 
Hashtable <String,String>codes = 

new Hashtable<String, String>(); 


codes.put(" ","x");//space character 


codes.put("A", ee 
codes.put("B", aa a a Ne 
codes.put("C", 2 ees 
codes ; put("D", er ; a) 
codes. put("E", Btn) he 
codes. put("F”, ".._."); 


Codes put('G > 


Codes. put (Hea 
CODES PULC LEN aa! )e 

codes.put("J",".__"); 
TA ai tead 
codes.put("L", W ey: 
codes.put("M", W aye 

codes.put("N", WW ae 

codes.put("0", W ee 
codes.put("P", ee Pe ie 
codes.put(" eth ae ee 
codes.put("R", Laie Ne 
codes. put("S" "4. ")s 
codes.put("T","_"); 

codes. put("U",™. ._"); 
See er 
codes.put("wW", WW pee 


codes.put("X", W Pea) ie 
codes.put("Y","_. =) 
codes.put("Z", W Se 
codes.put("1", W a 
codes.put("2", no ee 


Codes NUS). ae) 
GOUES DUG Aaa ae 
codes.put("5", UPS en ean eo ie 
codes.put("6", W egy 
codes.put("7", Seemnerteren acc) (a 
codes.put("8", eS 


codes.put("9","_____."); 
codes.put("0"," ea 
codes.put("error",".....00 oe 


With one exception, the hashtable is populated with Morse code values 
corresponding to the keys. The exception is the value for the key 


representing the space character. As far as I know, there is no Morse code 
value for a space character. In Morse code, a space is simply a short period 
of silence. Therefore, in this program, the value for the space character is 
"x", This will be interpreted later to indicate that there should be a short 
period of silence in the output corresponding to each space character in the 
message. 


The values for the letters and the numbers are populated with combinations 
of periods and underscore characters that represent the typical dot-dash 
patterns for the Morse code for each character. I could have used any two 
characters for this purpose but the use of dots and dashes made it look more 
conventional and also made it easier for me to visually check and confirm 
the accuracy. These combinations of dots and dashes will be used later to 
create a series of musical notes for each character. All of the musical notes 
will have the same pitch or frequency (middle C) but will have different 
lengths in time -- eighth notes, quarter notes, half notes, whole notes, etc. in 
musical terminology. 


Finally, the value for the key "error" is populated with eight dots, which is 
the standard Morse code sound for an error. 


Begin processing the input data stream 


The code in Listing 3 shows the beginning of a for loop that is used to get 
and process each character from the input message one character at a time. 
If a character is a newline character it is skipped. Otherwise, the character 
is extracted from the input data stream, converted to upper case if needed, 
and stored in the variable named ch . 


Note: 
Listing 3. Begin processing the input data stream. 


String ch = ""; 


String code = ""; 
String sound = "": 
for(int cnt = O;cnt < data.length();cnt++){ 


//Ignore newline characters. 
if(!(¢("" + data.charAt(cnt)).equals( 
PNA 1) ah 
//Convert all input characters to upper 
// Case. 
ch = ("" + data.charAt(cnt)). 
toUpperCase(); 


Get the Morse code for the character 


The code in Listing 4 begins by calling the get method on the hashtable to 
get the Morse code for the character passed as a key to the method. If there 
is no key matching the character, the get method returns null. In this case, 
the Morse code for an error is used to represent the character. This would 
happen, for example if the message contained a semicolon, which is not a 
key in the hashtable. 


Note: 
Listing 4. Get the Morse code for the character. 


//Get the code for the input character 
code = codes.get(ch); 


//Tf the input character is not in the 
// hashtable, transmit an error. 
if(code == null){ 

code = codes.get("error"); 


}//end if 


The output for HELLO WORLD 


Figure 1 shows the output melody file for the message HELLO WORLD. I 
will discuss the various parts of the contents of that file in the sections that 
follow. 


Note: 
Figure 1. The output for HELLO WORLD. 


Liax 
oy, 
Oy 
//H 
wes 
1,C4 
1,C4 
1,C4 
Sy 
//E 
1,C4 
3,X 
J/L 
1,C4 
3, C4 
1,C4 
1,C4 
3,X 
J/L 
1,C4 


3,C4 
dCA 
1,C4 
3,X 
iO. 
3,C4 
3,C4 
3,C4 
ous 
ho 
Sy 
3,X 
J/W ._ 
1,C4 
3,C4 
3,C4 
ones 
LAO! = 
3,C4 
3,C4 
3,C4 
3,X 
TER 
1,C4 
3,C4 
1,C4 
Seo 
Ga Ee pee 
1,C4 
3,C4 
CA 
1,C4 
3,X 
SADE Ses 
3,C4 
1,C4 
1,C4 


Display the character and the code 


The program code in Listing 5 displays the character and the code in the 
output file as shown by the first and fourth lines in Figure 1. A pair of 
forward slash characters (//) in the output file signifies a comment, which is 
ignored by the PPP that plays the melody. An x in the output file, as shown 
in Figure 1 and repeated below indicates a space in the input text stream. 


i? x 


The following line from the output shown in Figure 1 signifies the letter H 
as the first character in the word HELLO. (The Morse code for the letter 
"H" is four dots.) 


//H 


Compare this with the line in Listing 2 that shows the key and the value for 
the key equal to "H". 


This code could be eliminated with no detrimental impact on the overall 
performance of the program. It is simply icing on the cake. 


Note: 
Listing 5. Display the character and the code. 


SYSEEM.OUL. pringlim( "7/7" + cht)" 
code); 


Convert the Morse code to musical notes 


The code in Listing 6 converts the Morse code for the selected character to 
a sequence of musical notes. Those notes represent the sound of Morse code 
for the selected character when the file is played using the PPP. 


Note: 
Listing 6. Convert the Morse code to musical notes. 


for(int ctr = 0; ctr < code.length(); 
ctr+t+){ 
sound = "" + code.charAt(ctr); 
if(sound.equals(".")){ 
System.out.printin("1,C4"); 
selse if(sound.equals("_")){ 
System.out.printin("3,C4"); 
selse if(sound.equals("x")){ 
System.out.printin("3, xX"); 
}//end else if 
}//end for loop 


Interpretation of the programming code 


This is where some knowledge of the contents of the module titled Jbs2060- 
A Player Piano Simulator would come in handy. According to International 
Morse Code , 


Note: 


"If the duration of a dot is taken to be one unit then that of a dash is three 
units. The space between the components of one character is one unit, 


between characters is three units and between words seven units. To 
indicate that a mistake has been made and for the receiver to delete the last 
word, send di-di-di-di-di-di-di-dit (eight dots)." 


Consider the following series of musical notes that represent the letter "L". 


J/L 
CA 
3,C4 
0A 
104 
3,X 


As you can see, the Morse code for this letter has four components, one dot 
followed by one dash followed by two dots. Thus, there are four musical 
notes followed by a pause indicated by the "X". 


The number 1 means to hold the sound of the musical note for one unit in 
time. The number 3 means to hold the sound for three units in time. The 
"C4" specifies the pitch or frequency to be the same as Middle-C on a piano 
or 261.63 Hz. The "X" at the end means to maintain silence for three units. 


By taking this approach, it was not necessary for me to deal with the need 
to maintain one unit of silence between the dots and the dashes. The PPP 
was designed to make each note distinguishable from the next in a manner 
similar to the sound that you would hear by pressing a piano key repeatedly. 


One unit of time 


How much time is represented by one unit of time? This depends on the 
parameters used when the melody file is played by the PPP. The PPP deals 
with time in terms of the musical concept of beats . The program allows the 
user to specify the number of beats per second when playing the melody 
file. For example, the HELLO WORLD audio file that you downloaded and 
played earlier was created at eight beats per second. Without getting into the 


details of the computation, let me just say that experimentally, a string of 
100 "E" characters requires about 50 seconds to play at eight beats per 
second and about 25 seconds to play at 16 beats per second. 


Morse code speed 


Morse code speed is normally discussed in terms of words per minute or 
WPM. However, it is not clear exactly how speed in WPM is measured. 
Morse code characters have different lengths. Therefore, different words 
will have different lengths even if they have the same number of letters. The 
time required to transmit a message will depend on the words used in the 
message. 


One source that I found indicated that WPM is measured using standard 
five-letter words such as "PARIS" and "CODEX". I have determined 
experimentally that when the PPP is set to eight beats per second, six 
occurrences of the word PARIS followed by six occurrence of the word 
CODEX require almost exactly one minute to play. This suggests that a PPP 
rate of eight beats per second produces a Morse code rate of about twelve 
WPM. (There were no spaces between the words.) This further suggests that 
clicking here will allow you to download and listen to Morse code at about 
12 WPM. 


Changing the code speed 


With this approach, the playback speed in WPM for a given message can be 
changed by changing the "beats per second" parameter when playing the 
output melody file with the PPP. For example, increasing that parameter 
from eight to sixteen beats per second would double the speed of the 
HELLO WORLD audio file. If you would like to hear what 24 WPM 
sounds like, click here to download and play an audio file of the same 
message at twice the speed of the earlier version. 


Insert silence between characters 


The code in Listing 7 inserts silence for three units of time between 
message characters. That code also signals the end of the for loop and the 
end of the run method. 


Note: 
Listing 7. Insert silence between characters. 


System.out.printin("3, xX"); 
}//end if on newline 
}//end for loop 


}//end run 


Writing the output file 


By now, you may be wondering why I used the following Java code to write 
the output melody file. 


System.out.printin 


The answer is simply that I did it because it is an easy way to write an 
output text file containing multiple lines of text. This involves something 
called output redirection . If you are not familiar with that term, you may 
want to Google it. 


Listing 8 contains a Windows batch file that I use to run the program named 
MorseCodeGenerator01 . 


Note: 
Listing 8. Writing the output file. 


echo off 

del *.class 

del output.txt 

javac MorseCodeGenerator01.java 

java MorseCodeGenerator01 HelloWorld.txt > 
MorseCodeOutput.txt 

pause 


With one possible exception, everything in this batch file should be familiar 
to you. 


The file named HelloWorld.txt is the file containing the message that is to 
be translated into Morse code. The file named MorseCodeOutput.txt is the 
name of the output file that will contain the melody. Here is the possible 
exception mentioned above. The "greater than" angle bracket immediately 
to the left of the output file name instructs the operating system to route all 
output produced through execution of System.out.println statements in the 
program to a file with the given name. 


Reading the input file 


A method named readInputFile is used to read the text message that is to 
be translated into Morse code. There is nothing unique about that method so 
I won't discuss it further. You can view the method in its entirety in Listing 
9 


Run the program 


I encourage you to copy the code from Listing 9 . Create a text message for 
translation into Morse code. Compile and execute the program using your 
message file and a batch file similar to the one shown in Listing 8 . Then go 
to Jbs2060-A Player Piano Simulator and follow the instructions to play 
your Morse code melody file using the PPP. 


Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave 
as they do. For example, you might want to replace the output redirection 
with the use of a method to write the output file. 


Your smart phone probably has a built-in stop watch. Create a text file 
containing a large number (possibly 100) five-character groups of random 
letters and numbers. Think of each group as a "word." Translate the 
message and create the melody file. Use your timer to measure the amount 
of time required to play the melody file. Use that information to calculate 
the speed in WPM. Change the beats per second on playback and play it a 
few more times. Draw a graph showing the speed in WPM versus beats per 
second on playback. 


Complete program listing 


A complete listing of the program named MorseCodeGenerator01 is 
shown in Listing 9 below. 


Note: 
Listing 9. The program named MorseCodeGenerator01 


/*File MorseCodeGeneratorO1. java 
Copyright 2016 R.G.Baldwin 


04/28/16 

Reads a text file and generates an output file 
containing musical notes representing Morse code 
for the characters in the text file. Supports 


letters, numbers, and the space character. 
Generates an error code ........ for each 
unsupported character in the input text file. 


Must use output redirection to create the output 
file as in the following: 


java MorseCodeGeneratorOi1 in.txt > out.txt 


The output text file must then be moved to the 
Music folder to be compatible with the 
MusicComposerO09.java program. 


FERS SRR ERAN ROS Wake thot ee Rake Matin hot he Ve Re ee eon ea igh race G7, 


import java.io.FileReader,; 
import java.io.BufferedReader ; 
import java.util.”*; 


public class MorseCodeGeneratoro1{ 
public static void main(String[] args){ 
run(args[0]); 
}//end main 


static void run(String inputFile){ 
//Read the input data 
String data = readInputFile(inputFile); 


//Create a hash table containing the codes 
// for letters, numbers, the space character, 
// and an error character. 
Hashtable <String,String>codes = 

new Hashtable<String, String>(); 


codes.put(" ","x");//space character 
codes ; put("A", W hace ys 

codes , put("B", ae a W ye 

codes : put("C", Lager W ie 


codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 
codes. 


put("D", W 


put("E", n 
put("F", Ms ’ 
put("G", —_ 
put("H", W rates Co 
UE ee oe. : 
on ira (dance Deg eee 
put("K", oe = 
put("L", Mio oe 
put("M", ee 
put("N", aoe 

put("0O", es 
put("P", ene a 
put("Q", hae 7 


put("R", W 


put("S", W ae 


DUE say W 


put("U", W Eds 
Re ee W anes a 


put("Y", W 
put("Z", W 


put("2", ES 
PUTS re eo) 
DUR 4. are 


put("5", W 


DUC Ge 
(oy Wel Gees Acca eae 
DUC Sy 


put("9", W 
put("0", W 


put("error"," 


String ch = ""; 
String code = ""; 


a 


=o) 
a 


String sound = = eee 
for(int cnt = @;cnt < data.length();cnt++){ 


//Ignore newline characters. 
if(!(("" + data.charAt(cnt)).equals( 
NEL) 
//Convert all input characters to upper 
// case. 
ch = ("" + data.charAt(cnt)). 
toUpperCase(); 
//Get the code for the input character 
code = codes.get(ch); 


//If the input character is not in the 
// hashtable, transmit an error. 
if(code == null){ 

code = codes.get("error"); 
}//end if 


//Display the character and the code in 

// the output file. 

//An X in the output file indicates a 

// space in the input text stream. 

System.out.println("//" + ch +" " + 
code); 


//Convert the code to musical notes that 
// represent Morse code for the character 
// when the file is played using the 
// PlayerPianoO1 program. 
for(int ctr = 0; ctr < code.length(); 
ctrt+t+){ 
sound = "" + code.charAt(ctr); 
if(sound.equals(".")){ 
System.out.printin("1,C4"); 
telse if(sound.equals("_")){ 
System.out.printin("3,C4"); 


selse if(sound.equals("x")){ 
System.out.printin("3,X"); 
}//end else if 
}//end for loop 
//Insert a short silence between 
// characters. 
System.out.printin("3,X"); 
}//end if on newline 


}//end for loop 


}//end run 
[[------ 7-2-2 rr errr re rr eee rere eee // 


//This method is used to read the input file 

// containing the message that is to be 

// translated to Morse code. 

static String readInputFile(String inputFile){ 
String pathAndFileName = inputFile; 


String output = "": 
String line = ""; 
try{ 
FileReader fileReader = 
new FileReader(pathAndFileName) ; 
BufferedReader bufferedReader = 
new BufferedReader (fileReader ) ; 
while((line = 
bufferedReader.readLine()) != null){ 
output += line + "\n"; 
}//end while loop 
fileReader.close(); 


}catch (Exception e) { 
e.printStackTrace(); 

}//end catch 

return output; 


}//end readInputFile 


[i el RUAN A ETRE EP UA ntl Rn CP yi 
}//end class MorseCodeGeneratoro1 
a= Sa ee ee ay, 
Miscellaneous 


This section contains a variety of miscellaneous information. 


Note: 
Housekeeping material 


e Module name: Morse1010 Translating Text to Morse Code 
e File: Morse1010.odt 
e Published: 04/29/16 


Note: 

Disclaimers: 

Although the OpenStax site makes it possible for you to download a PDF 
file for this module at no charge, and also makes it possible for you to 
purchase a pre-printed version of the PDF file, you should be aware that 
some of the HTML elements in this module may not translate well into 
PDF. 

I also want you to know that, I receive no financial compensation from the 
OpenStax website even if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from OpenStax, 
converted them to Kindle books, and placed them for sale on Amazon.com 
showing me as the author. I neither receive compensation for those sales 


nor do I know who does receive compensation. If you purchase such a 
book, please be aware that it is a copy of a module that is freely available 
on OpenStax and that it was made and published without my prior 
knowledge. 


-end- 


